home *** CD-ROM | disk | FTP | other *** search
/ CD School House 9 / CD School House 9.0 - Wayzata Technology (1994).iso / pc / dos / math / eebond / sdfcvt.exe / COMMAND.SDF next >
Text File  |  1993-04-08  |  6KB  |  156 lines
  1.     (C) Copyright 1991-1993 by Alan J. Avery.  All Rights Reserved.
  2.  
  3.     Sample command file for SDF.EXE, the program that lets the user convert
  4.     delimited ASCII files without programming and without using a spreadsheet,
  5.     database, word processor or other major application program.
  6.     The basic format of this file is simple:
  7.    
  8.     Start comments with a space, tab, asterisk or semicolon in column 1.
  9.  
  10.     Blank lines will be ignored, as will anything that is not recognized
  11.     to be a command.
  12.  
  13.     Commands MUST start in column 1 (!) and can be in UPPER or lower case.
  14.     If a command requires a value associated with it, this value must
  15.     begin in column 21 or later!
  16.     Some commands pertain to processing the entire file, others pertain to
  17.     processing a particular field.  File commands are listed first in this
  18.     sample command file, field commands follow.
  19.  
  20.     ONLY - Force the fields specified below to be kept in the file that is
  21.            created, and no others.
  22. Only
  23.  
  24.     REORDER - Force the fields to be kept in the order encountered in this file.
  25.     Note! If you use REORDER, then ONLY is assumed as well.
  26. Reorder
  27.  
  28.     INPUT FILE - File to be processed.
  29. Input File          FILE1.PRN
  30.     OUTPUT FILE - File to be created.  The extension is ignore for PARADOX files.
  31. Output File         FILE2.DBF
  32.  
  33.     FIELDS PER LINE - Maximum # of fields to expect per line.  Keep this small.
  34.                       Default is 500.
  35. Fields Per Line     400
  36.  
  37.     SURROUNDED BY - Character that surrounds fields in the file (if any).
  38. Surrounded By       "
  39.     DELIMITED BY - Character that delimits fields in the file.
  40. Delimited By        ,
  41.     FILL WITH - Character used to fill unused space in the output file.
  42.             (Specify as an ASCII number from 0-255.  Default is 32 [Space])
  43.             (Can also be specified as a character by simply entering the
  44.               character in column 21, if it is not a control character.)
  45. Fill With           0
  46.  
  47.     LINE START - Start processing at this line.
  48. Line Start          1
  49.     LINE END - End processing at this line.
  50. Line End            200
  51.  
  52.     MAXIMUM LENGTH - Maximum length for any field.
  53. Maximum Length
  54.     MINIMUM LENGTH - Minimum length for any field.
  55. Minimum Length
  56.     OMIT IF EMPTY - Forces empty fields to be omitted.
  57. Omit If Empty
  58.  
  59.     OUTPUT FORMAT - Type of output file to create.
  60.     Choices are SDF (default, for System Data Format),
  61.                DEL (for delimited)
  62.                DB3 (for dBase III type)
  63.                PDX35 (for Paradox 3.5)
  64.                PDX40 (for Paradox 4.0)
  65.                PDX   (for Paradox 4.0)
  66. Output Format       SDF
  67. Output Format       DB3
  68. Output Format       DEL
  69. Output Format       PDX35
  70. Output Format       PDX40
  71. Output Format       PDX        (same as PDX40)
  72.  
  73.     SURROUND WITH - Character that surrounds fields in output file (if any).
  74.                 Note: This is only applicable if DEL is the output format.
  75. Surround With       "
  76.     DELIMIT WITH - Character that separates fields in output file (if any).
  77.                 Note: This is only applicable if DEL is the output format.
  78. Delimit With        ,
  79.     Note: Use the \## form of the parameter to specify an ASCII character.
  80.           Here, the symbol \32 signifies a [Space].
  81. Delimit With        \32
  82.  
  83.                               
  84.     Field commands follow.    
  85.                               
  86.     FIELD NUMBER - designates the field that these commands will pertain to.
  87.                    It must precede any field commands that are used.
  88. Field Number        1
  89.     FIELD START - Character position to start reading data from.
  90.                   In this example, no characters are skipped.
  91. Field Start         1
  92.     FIELD LENGTH - Length of this field in the output file.
  93. Field Length        20
  94.     FIELD NAME - If Output Format is DB3, this gives the field a name.
  95. Field Name          Text
  96.     FIELD TYPE - If Output Format is DB3, this specifies a field type.
  97.     FIELD TYPE - If Output Format is PDX35 or PDX40 or PDX, this specifies
  98.                         a Paradox field type.  Only Alphanumeric is supported.
  99. Field Type          C    (for DB3)
  100. Field Type          A15    (for PDX, this specifies alphanumeric of length 15)
  101.     SEARCH FOR - Search for specific text in this field.
  102. Search For          Text
  103.     RESPECT CASE - Be sensitive to upper/lowercase when searching for text.
  104.                    Default is Y or T.
  105. Respect Case        Y
  106.     MUST HAVE - If Y or T, any records that do NOT have the desired text
  107.                 will be discarded.
  108. Must Have           N
  109.     MUST NOT HAVE - If Y or T, any records that DO have the desired text
  110.                 will be discarded.
  111. Must Not Have       N
  112.     REPLACE WITH - If the text sought is found, it can be replaced with the text
  113.                    specified in this command.
  114. Replace With        Text
  115.     INIT WITH - Text used to initialize field prior to working on it.
  116. Init With           Text
  117.     CONVERT TEXT - Convert field to Upper, lower or proper case.
  118.                    THIS IS UPPER CASE. (all letters capitalized)
  119. Convert Text        Upper
  120.                    this is lower case. (no letters capitalized)
  121. Convert Text        Lower
  122.                    This Is Proper Case. (First letter capitalized)
  123. Convert Text        Proper
  124.     Note: 'Convert Text' is executed prior to any 'Search For' (and 
  125.           'Replace With') commands.
  126.  
  127.     JUSTIFY - Align text in a field to the extreme left or extreme right.
  128. Justify             Right
  129. Justify             Left
  130.     TRIM FRONT - Number of characters to trim from the front of a field
  131.                  after it's been completely processed.  This also reduces
  132.                  the length a field receives.
  133. Trim Front          10
  134.     TRIM BACK - Number of characters to trim from the end of a field after
  135.                 it's been completely processed.  This also reduces the
  136.                 length a field receives.
  137. Trim Front          10
  138.  
  139.     The above commands only apply to ONE field.  For each additional field,
  140.     specify the required 'Field Number' command, followed by the commands
  141.     you want applied to the field.
  142.  
  143.     INDEX - This command can be used only when OUTPUT FORMAT specifies a
  144.             PARADOX 3.5 or PARADOX 4.0 database.  When it is used in each of
  145.             the first few fields, a PRIMARY index is set up.  If one or more
  146.             fields have been defined since the last INDEX command was
  147.             encountered, a SECONDARY index (automatically maintained by
  148.             PARADOX) is set up.
  149. Index
  150.  
  151.     SECONDARY INDEX - Use this to have SDF set up a secondary index on the
  152.             current field (automatically maintained by Paradox) when it
  153.             creates the PARADOX database.
  154.  
  155. Secondary Index
  156.